Gigma

Калькулятор и подсказки

С помощью этих методов вы можете рассчитать цену и заполнить серверные формы подсказками по адресам, банкам, компаниям, городам и номенклатуре.

Все запросы этой страницы требуют Bearer сотрудника. Не вызывайте их из открытого клиентского кода.

Рассчитать цену

Рассчитать стоимость товара

Метод
POST
URL
https://api.gigma.ru/api/orders/calculator
Авторизация
Bearer сотрудника
Headers
Authorization: Bearer {token}; Content-Type: application/json; Accept: application/json

Метод рассчитывает итоговую цену с учётом наценки и скидки и не сохраняет результат.

Параметры запроса

  • price (number, обязательный) — базовая цена;
  • markup (number, обязательный) — наценка в процентах; передайте 0, если наценки нет;
  • discount (number, обязательный) — скидка в процентах; передайте 0, если скидки нет.

Пример запроса

{
	"price": 1000,
	"markup": 40,
	"discount": 1
}

Ответ

{
	"price": 1414
}

Поля ответа

  • price — итоговая стоимость.

Ошибки

  • 401 — Bearer сотрудника отсутствует или недействителен.

Найти адрес

Найти адрес

Метод
POST
URL
https://api.gigma.ru/api/search_address
Авторизация
Bearer сотрудника
Headers
Authorization: Bearer {token}; Content-Type: application/json; Accept: application/json

Параметры запроса

  • query (string, обязательный) — поисковая строка.

Пример запроса

{
	"query": "Деловая 20, Москва"
}

Ответ

{
	"addresses": [
		{
			"name": "г Москва, ул Деловая, д 20",
			"value": "115477, г Москва, ул Деловая, д 20"
		}
	],
	"addressesCount": 1
}

Показывайте пользователю name, а в данные формы сохраняйте полное значение value.

Найти банк

Найти банк

Метод
POST
URL
https://api.gigma.ru/api/search_bank
Авторизация
Bearer сотрудника
Headers
Authorization: Bearer {token}; Content-Type: application/json; Accept: application/json

Ищите банк по БИК или названию.

Параметры запроса

  • query (string, обязательный) — БИК или часть названия банка.

Пример запроса

{
	"query": "Сбер"
}

Ответ

{
	"banks": [
		{
			"name": "ПАО Сбербанк",
			"bik": "044525225",
			"kpp": "773601001",
			"payment_account": "",
			"address": "117997, г Москва, ул Вавилова, д 19"
		}
	],
	"banksCount": 1
}

Найти компанию

Найти компанию

Метод
POST
URL
https://api.gigma.ru/api/search_company
Авторизация
Bearer сотрудника
Headers
Authorization: Bearer {token}; Content-Type: application/json; Accept: application/json

Ищите юридическое лицо по названию, ИНН или ОГРН.

Параметры запроса

  • field (string, обязательный) — name, inn или ogrn;
  • query (string, обязательный) — поисковая строка.

Пример запроса

{
	"field": "inn",
	"query": "7707083893"
}

Ответ

{
	"companies": [
		{
			"name": "ООО «Пример»",
			"inn": "7707083893",
			"ogrn": "1027700132195",
			"legal_address": "125009, г Москва, ул Примерная, д 1",
			"kpp": "770701001",
			"head": "Иванов Иван Иванович",
			"registration_date": "2020-04-02"
		}
	],
	"companiesCount": 1
}

Получить города

Получить список городов

Метод
GET
URL
https://api.gigma.ru/api/cities
Авторизация
Bearer сотрудника
Headers
Authorization: Bearer {token}; Accept: application/json

Ответ

{
	"cities": [
		{
			"id": 1,
			"name": "Новосибирск",
			"avatar": "https://api.gigma.ru/storage/uploads/default.svg",
			"created_at": "2024-03-27T07:00:46.000000Z"
		},
		{
			"id": 2,
			"name": "Москва",
			"avatar": "https://api.gigma.ru/storage/uploads/default.svg",
			"created_at": "2024-03-27T07:00:46.000000Z"
		}
	],
	"citiesCount": 2
}

Получить город

Метод
GET
URL
https://api.gigma.ru/api/cities/{id}
Авторизация
Bearer сотрудника
Headers
Authorization: Bearer {token}; Accept: application/json

Параметры пути

  • id (integer, обязательный) — ID города.

Ответ

{
	"city": {
		"id": 1,
		"name": "Новосибирск",
		"avatar": "https://api.gigma.ru/storage/uploads/default.svg",
		"created_at": "2024-03-27T07:00:46.000000Z"
	}
}

Найти номенклатуру

Найти номенклатуру

Метод
POST
URL
https://api.gigma.ru/api/search_nomenclature
Авторизация
Bearer сотрудника
Headers
Authorization: Bearer {token}; Content-Type: application/json; Accept: application/json
Успешный ответ
200

Параметры запроса

  • query (string, обязательный) — часть названия.

Пример запроса

{
	"query": "крем"
}

Ответ

Gigma вернёт массив совпадений по названию.

Дальнейшие шаги